home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Diamond Collection / The Diamond Collection (Software Vault)(Digital Impact).ISO / cdr34 / jam125sw.zip / README.DOC < prev    next >
Text File  |  1995-03-10  |  41KB  |  949 lines

  1.  
  2. README.DOC
  3.  
  4. JAM (tm)  Version 1.25  Release Notes  (Mar 10 1995)
  5. ====================================================
  6.  
  7. This file contains the following topics:
  8.  
  9.   1. Release highlights
  10.   2. Files on the distribution disk
  11.   3. Getting started
  12.      3.1. Upgrading the JAM from an older version
  13.      3.2. Quick Installation Guide
  14.   4. Hints on JAM usage
  15.   5. Compatibility with certain software utilities
  16.      5.1. DOS versions
  17.      5.2. Memory managers
  18.      5.3. Viruses & Anti-virus Software
  19.      5.4. D*Space, Stacker, and other disk compressors
  20.      5.5. Networks
  21.      5.6. INTERLNK & INTERSVR programs
  22.      5.7. Disk repairing/defragmentation utilities
  23.      5.8. UnErase/UnDelete utilities
  24.      5.9. Disk Cache utilities
  25.      5.10. Data encryption software
  26.      5.11. Windows 3.xx
  27.      5.10. Executable file compressors
  28.   6. Possible problems
  29.      6.1. JMOUNT displays the message "JAM file is too fragmented".
  30.      6.2. Your program tells that the JAM drive is write-protected.
  31.      6.3. You find that your JAM drive mounting as a read-only disk.
  32.      6.4. You cannot copy files onto JAM drive when it is not full.
  33.   7. Addendum to the JAM User's Guide
  34.      7.1. The JCHAIN utility
  35.      7.2. The JPROTECT utility
  36.   8. Technical support
  37.  
  38.  
  39. 1. Release Highlights
  40. ======================
  41.  
  42. This new (1.25) release features several advantages  over  previous
  43. releases:
  44.  
  45.   * Superior Reliability -- the JAM device driver uses now advanced
  46.     technology of interaction with DOS, that resolves all possible 
  47.     problems with memory managers, disk caches, multitasking 
  48.     environments, networks, and even with other disk compressors!
  49.     You can load JAM driver at any place in your CONFIG.SYS or even 
  50.     later (using any existing device loaders).  Finally, you can link 
  51.     your JAM drives at any point in your file system with the SUBST, 
  52.     ASSIGN and JOIN commands.
  53.  
  54.   * New JCHAIN Utility -- a system configuration utility. You can use
  55.     JCHAIN to instruct DOS to use additional configuration files.
  56.     Thus, you can arrange all the DEVICE= instructions for loading the
  57.     JAM into a separate file, and transfer control on it before (or
  58.     after) the standard CONFIG.SYS file is executing.
  59.  
  60.   * New JPROTECT Utility -- an ultimate file protection tool.
  61.     You can use JPROTECT to protect your compressed data from possible
  62.     damages by ill-behaved programs, viruses, etc.
  63.  
  64.   * Improved removable drive simulation -- when JAM drive is not active
  65.     (unmounted), or it is mounted on a JAM file located on a floppy disk,
  66.     PCMCIA card, or any other removable media, you will see it as a
  67.     removable drive in your system (File Manager will display a floppy
  68.     drive). However, if you run JMW or JMOUNT and mount it to a file
  69.     located on a hard disk, that drive will be recognized as a fixed disk
  70.     drive.
  71.  
  72.   * Improved JSWAP Utility -- automatically switches drive letters and
  73.     all the related system parameters: system bootable drive, current
  74.     drive, host drives of all JOINed drives and SUBST'ed directories;
  75.     drive letters in COMSPEC=, PATH= and the other system variables,
  76.     host drives of JAM files, etc. When you run JSWAP without parameters,
  77.     the current drive map is displayed.
  78.  
  79.   * Improved JCREATE, JMOUNT, and JSIZE utilities -- all these
  80.     utilities can determine attempts to create, mount, or edit JAM
  81.     files located on redirected (ASSIGN, JOIN, SUBST, etc), phantom
  82.     (DRIVER.SYS-driven), or compressed (JAM, Stacker, DoubleSpace,
  83.     and DriveSpace) drives.
  84.  
  85.   * Improved JMAX utility -- more detailed disk integrity analysis
  86.     before optimization; improved data compression algorithm (1..2%
  87.     extra compression)!
  88.  
  89.   * and many other advantages ...
  90.  
  91.  
  92. 2. Files on the disk
  93. =====================
  94.  
  95. The JAM 1.25 distribution contains the following files:
  96.  
  97.     README.DOC      This file
  98.     JAM.SYS         The JAM device driver
  99.     JCREATE.COM     JAM archive files creation utility
  100.     JMOUNT.COM      JAM drives mount/dismount utility
  101.     JDIR.COM        Extended directory display utility
  102.     JSIZE.COM       Archive size modification utility
  103.     JMAX.COM        JAM drives recompressor/defragmenter
  104.     JCHKDSK.COM     Drive check/repair utility
  105.     JSWAP.COM       Drive switcher
  106.     JCMD.COM        JAM command interceptor (replaces DOS "DIR"
  107.                     and "CHKDSK" commands by JDIR and JCHKDSK)
  108.     JMW.EXE         \
  109.     JMW.HLP          | JMW (JMount for Windows)
  110.     CTL3DV2.DLL      | utility files
  111.     JMOUNT.PIF      /
  112.     JCHAIN.SYS      System configuration utility
  113.     JPROTECT.SYS    \ A file protection utility
  114.     JPROTECT.DOC    / and documentation
  115.     CHKALL.BAT      Checks all JAM drives        \  examples on using
  116.     EXTEND.BAT      Extends specified JAM drive   | JAM utilities
  117.     SHRINK.BAT      Shrinks specified JAM drive  /  in batch files
  118.     JAM.DOC         JAM User's Guide
  119.     REGISTER.DOC    JAM registration information
  120.     AUTHORS.DOC     List of people involved in the development of JAM 1.25
  121.     AVAIL.DOC       Information on JAM distribution
  122.  
  123.  
  124. 3. Getting Started
  125. ===================
  126.  
  127. 3.1. Upgrading the JAM from an older version
  128. ---------------------------------------------
  129.  
  130. This version of the JAM is NOT COMPATIBLE with versions prior 1.05 !
  131. If you are upgrading the JAM from an older version, you should BackUp
  132. the files on the existing JAM Drives, delete corresponding Archive Files,
  133. install new version of the JAM, and restore files you have BackUp.
  134.  
  135.  
  136. 3.2. Quick Installation Guide
  137. ------------------------------
  138.  
  139. The following steps should be taken before you start:
  140.  
  141.   1. Check your file system integrity by CHKDSK (or ScanDisk) utility
  142.  
  143.   2. Defragment your hard disk drives using a disk optimization utility
  144.      like DEFRAG (MS-DOS/PC-DOS 6.0+), DISKOPT (DR-DOS 6, Novell DOS 7),
  145.      SPEEDISK (Norton Utilities), COMPRESS (PC-TOOLS), OPTune, etc.
  146.  
  147.      If you have not any of the commercial programs above, or you find
  148.      that your defragmenter works too slow, we could suggest you to try
  149.      a shareware Disk OrGanizer by G. Allen Morris:
  150.           ftp: oak.oakland.edu:/SimTel/msdos/diskutils/dog316.zip.
  151.  
  152.   3. Copy the JAM files (see above) on your hard disk.
  153.  
  154.      DO NOT compress files JMOUNT.COM, JCREATE.COM and JSWAP.COM by
  155.      executable file compressors like LZEXE, PKLITE, etc. See section
  156.      5.11 for details.
  157.  
  158.   4. Check your system configuration (files CONFIG.SYS and AUTOEXEC.BAT)
  159.  
  160.      4.1. If you have installed the JAM with version prior 1.05, please
  161.           read the Section 4. "Upgrading the JAM from an older version".
  162.  
  163.      4.2. If you have installed QEMM 7.0x with enabled DOS-UP feature,
  164.           please read the Section 5.2 in this file.
  165.  
  166.      4.3. If you have installed Stacker, DoubleSpace, SuperStor, or
  167.           other disk-compression system, read the Section 5.4 below.
  168.  
  169.      4.4. If you use a disk cache utility, read the Section 5.9.
  170.  
  171.   5. Install the JAM, using the instructions in JAM.DOC  Chapter 2 -
  172.      "Getting Started With the JAM". Note that now you can also create
  173.      extendable archive files (use JCREATE with /X switch). This allows
  174.      you make a small archive file, using available free space on your
  175.      hard disk, then move some files from the host drive on the JAM one,
  176.      then extend size of JAM archive (using JSIZE utility), and so on.
  177.      The same technique can be applied to deinstallation as well.
  178.  
  179.   6. In case of problems, please refer to this README and JAM
  180.      documentation.
  181.  
  182.  
  183. 4. Hints on JAM usage
  184. ======================
  185.  
  186. This section provides a list of typical first-time questions asked
  187. about the JAM driver and utilities. Please refer to other sections of
  188. README.DOC (5 - Compatibility and 6 - Possible problems) and to the
  189. JAM.DOC for further information.
  190.  
  191. Q. How can I create a second JAM drive?
  192.  
  193. A. 1. Check your file system integrity by CHKDSK (or ScanDisk) utility
  194.  
  195.    2. Defragment your hard disk drives using a standard disk
  196.       optimization utility (MS-DOS/PC-DOS 6.0+ DEFRAG, etc.)
  197.  
  198.    3. Run JCREATE <filename> /s=Kbytes [/x if extendable]
  199.  
  200.    4. Edit your COMFIG.SYS file and:
  201.  
  202.       4.1. add the /M=2 switch in line:
  203.                DEVICE=<drive:path>\JAM.SYS
  204.  
  205.       4.2. add a new line below:
  206.                DEVICE=<drive:path>\JMOUNT.COM <filename>
  207.          where:
  208.            <drive:path> - is a drive/directory where the JAM utilities
  209.                           are located
  210.            <filename>   - full name of the newly created JAM file
  211.  
  212.       4.3. Save file CONFIG.SYS and exit editor.
  213.  
  214.    5. Reboot your computer.
  215.  
  216. Q. How can I enlarge capacity of an existing JAM drive?
  217.  
  218. A. 1. Run JMOUNT <drive:>
  219.       to show the host drive and name of your JAM file
  220.  
  221.    2. Run JMOUNT /D <drive:>
  222.       to deactivate your JAM drive
  223.  
  224.    3. Defragment your host drive using a standard disk
  225.       optimization utility (MS-DOS/PC-DOS 6.0+ DEFRAG, etc.)
  226.  
  227.    4. Run JSIZE <filename> +[Kbytes]
  228.       to extend the JAM file
  229.  
  230.    5. Run JMOUNT <filename> <drive:>
  231.       or reboot your computer to make your JAM drive active.
  232.  
  233. Q. JAM creates drive letters which conflict with my old network drives
  234.    or compressed ones. How can I resolve this?
  235.  
  236. A. Either put JAM.SYS driver on the end of CONFIG.SYS, or use JSWAP
  237.    utulity (from CONFIG.SYS or AUTOEXEC.BAT).  See JAM.DOC for details
  238.    (section 4.2, 4.8).
  239.  
  240. Q. I cannot undelete files on JAM drive.
  241.  
  242. A. Refer to section 5.8 of README.DOC. In brief, you should use
  243.    JMOUNT /W+D before you run undelete.  See also JAM.DOC for
  244.    further details (section 4.3).
  245.  
  246. Q. When I calculate total space used by all my files and subtract it
  247.    from original total capacity of empty JAM drive, I did not get the
  248.    same free space as DIR command reports. What's wrong?
  249.  
  250. A. The JAM driver uses complicated algorithm to estimate the real free
  251.    space depending on current usage of the disk and current compression
  252.    ratio. For example, if you would fill your JAM drive with already
  253.    compressed files (for example, .zip files), the projected free space
  254.    would drop very fast. Use JCHKDSK to obtain accurate report of used
  255.    and free physical and logical disk space.  See JAM.DOC for details
  256.    (sections 3.3 and 4.5).
  257.  
  258. Q. How can I convert my existing compressed drives (e.g., Stacker,
  259.    Doublespace) to JAM?
  260.  
  261. A. At the present time, not automatically. You should create a small
  262.    resizable JAM drive (use JCREATE MYDRIVE /X /S=500, for example),
  263.    then move some files from your old compressed drive to it, shrink
  264.    that compressed drive and extend JAM's one, and repeat until all
  265.    files are moved. Or, it may be simpler to back up your data and
  266.    restore it on JAM drive. See JAM.DOC for details on using JCREATE
  267.    and JSIZE (sections 4.1 and 4.7).
  268.  
  269. Q. JCMD seems to not work. What is happening?
  270.  
  271. A. First, check if you have specified path for JAM utilities, e.g.:
  272.  
  273.    jcmd /i c:\jam
  274.  
  275. Then, check if you are using 4DOS or NDOS. If so, make sure you've 
  276. loaded the JCMD from any program shell (Norton Commander, Volkov 
  277. Commander, XTreeGold, etc.).  
  278.  
  279. Explanation: to replace commands JCMD uses DOS interrupt 2Fh.
  280. When you load JCMD from your program shell, 4DOS intercepts int 2Fh 
  281. handler, loads JCMD in memory, then exits restoring original interrupt 
  282. 2Fh handler.  This effectively unlinks JCMD from the interrupt chain.
  283.  
  284. If you are running Volkov Commander, and you've loaded JCMD from it, 
  285. JCMD will be automatically deactivated when VC exits.
  286.  
  287. Rule of Thumb: run TSRs from DOS command prompt (or AUTOEXEC.BAT).
  288.  
  289.  
  290. 5. Compatibility with certain software utilities
  291. =================================================
  292.  
  293. 5.1. DOS versions
  294. -----------------
  295.  
  296. The JAM 1.25 is fully compatible with the following Disk Operating Systems
  297. (Control Programs):
  298.  
  299.     1. PC-DOS 3.30, 5.02, 6.01, and 6.3
  300.     2. MS-DOS 3.30, 4.01, 5.0, 6.0, 6.2, 6.22, and 7.0
  301.     3. Compaq DOS 3.31, 5.0
  302.     4. DR-DOS 6.0 (April 1992 and earlier releases)
  303.     5. DR-DOS 6.0 March 1993 "business update"
  304.     7. Novell DOS 7
  305.  
  306. NOTES:
  307.  
  308.  1. To prevent possible conflicts with other Disk Operating Systems,
  309.     we have not tested, JAM driver checks the DOS OEM number. If DOS
  310.     version is between 3.30 and 7.0, but OEM number is neither 00h
  311.     (IBM), 01h (Compaq), nor 0FFh (Microsoft), the JAM driver will
  312.     display the error message like:
  313.  
  314.     'Warning: Incorrect DOS OEM number.'
  315.  
  316.     In this case (or in case if you have newer release of PC-DOS,
  317.     MS-DOS, or Novell DOS than listed above) you could contact us for
  318.     upgrade information (see section 8. Technical Support below).
  319.  
  320.  2. This method cannot detect several other uncommon Operating Systems.
  321.     For example, it is possible to load JAM driver under PTS-DOS,
  322.     BMT-DOS, etc. which, in fact, are not compatible with JAM 1.25.
  323.  
  324.  
  325. 5.2. Memory managers
  326. ---------------------
  327.  
  328. The JAM 1.25 is compatible with all memory managers we have tested
  329. including HIMEM, EMM386 (supplied with PC-DOS, MS-DOS, DR-DOS, and
  330. Novell DOS), QEMM386 and 386MAX.  Occasionally, the memory manager will
  331. require special parameters to work properly, or you will need to change
  332. order of loading the JAM components.
  333.  
  334. Some detailed information about particular products is given below:
  335.  
  336. QEMM:
  337.     The JAM is fully compatible with Quarterdeck's QEMM 5.0-7.5+,
  338.     including such new technologies as Stealth ROM and DOS-Up features.
  339.  
  340.     If you want to load portions of DOS into upper memory, using the
  341.     QEMM 7.0+ DOS-Up program, you should ensure that there is no lines
  342.     like:
  343.  
  344.         DEVICE=<drive/path>\JMOUNT.COM <switches> <file_to_mount>
  345.         DEVICE=<drive/path>\JCREATE.COM <switches> <file_to_create>
  346.  
  347.     or (in case of DR-DOS or Novell DOS 7)
  348.  
  349.         INSTALL=<drive/path>\JMOUNT.COM <switches> <file_to_mount>
  350.         INSTALL=<drive/path>\JCREATE.COM <switches> <file_to_create>
  351.  
  352.     in your CONFIG.SYS file. The point is that DOS-Up is incompatible
  353.     with DR-DOS's INSTALL command, and with similar loading method used
  354.     by JMOUNT and JCREATE utilities. If you are using either of these
  355.     commands in your CONFIG.SYS file, load the JMOUNT and/or JCREATE
  356.     utilities from AUTOEXEC.BAT instead.
  357.  
  358. 386MAX:
  359.     The JAM is fully compatible with Qualitas's 386MAX (6.0-7.0) memory
  360.     manager, running on PC with MS/PC-DOS 5.0 or Novell DOS 7 and higher
  361.     in use. If you run 386MAX with one of the older PC/MS/DR-DOS versions,
  362.     the JAM.SYS device driver cannot be loaded into upper memory.
  363.  
  364. RAMBOOST:
  365.     If you're running JMOUNT utility with the DEVICE= command at
  366.     CONFIG.SYS, RAMBOOST would try to load JMOUNT into upper memory,
  367.     and as the result your JAM files may not be mounted after the
  368.     analysis phase. To prevent these attempts add to the RAMBOOST.INI
  369.     file the following lines:
  370.  
  371.     [pif.advice]
  372.  
  373.     ; jam pseudo-drivers:
  374.     jmount.com=low,             locked
  375.     jcreate.com=low,            locked
  376.     jswap.com=low,              locked
  377.  
  378.  
  379. 5.3. Viruses & Anti-virus Software
  380. -----------------------------------
  381.  
  382. Unlike other real-time compressors (e.g. Stacker or XtraDrive) the JAM does
  383. not modify boot-sector parameters during initialization. So, you may use
  384. any virus detector without any restriction (and possibility to see
  385. annoying messages like 'Brand X has detected a program trying to write to
  386. the boot record.' during each system start-up :-).
  387.  
  388. If your machine has a virus, the JAM can affect the way the virus writes
  389. itself on disk and/or an anti-virus corrects this. For example, JAM's
  390. [DirectWrite] protection feature prevents distribution of several dozen
  391. known viruses, although, it can also make some difficulties for anti-virus
  392. software in repairing infected files. So, if your anti-virus tells that
  393. the JAM drive is write-protected, while you can copy and/or delete files on
  394. it, you should enable [DirectWrite] mode (using JMOUNT /W+D) and run anti-
  395. virus again.
  396.  
  397. JAM 1.25 includes a new JPROTECT utility, which you can use to protect
  398. your executable files from virus infections. This utility is quite
  399. small, and in combination with JAM [DirectWrite] protection feature
  400. provides comparative with standard antivirus TSRs (e.g. MS-DOS 6+ VSAFE
  401. program) level of virus protection.
  402.  
  403. For more information about JPROTECT utility, please read the file
  404. JPROTECT.DOC.
  405.  
  406.  
  407. 5.4. D*Space, Stacker and other disk compressors
  408. -------------------------------------------------
  409.  
  410. JAM 1.25 is fully compatible with MS-DOS 6+ DoubleSpace, and
  411. MS-DOS 6.22 DriveSpace disk compressors. You can load the JAM driver
  412. at any line in your CONFIG.SYS file and work with your JAM- and
  413. D*Space drives without any restrictions.
  414.  
  415. We DO NOT RECOMMEND you use the JAM with other disk compressors (like
  416. Stacker, SuperStor, etc.) simultaneously. Nevertheless, you can install
  417. the JAM on a machine with Stacker, SuperStor, XtraDrive, or some other
  418. real-time compression program, and run it for evaluation purpose.
  419.  
  420. The main requirements here are:
  421.  
  422.   * create JAM archive files only on UNCOMPRESSED hard disk drives
  423.     (and vice-versa do not create Stac'ed drives over the JAM ones).
  424.  
  425.   * try to avoid reaching the space limits on your compressed drives by
  426.     frequently checking its free space.
  427.  
  428.  
  429. 5.5. Networks
  430. --------------
  431.  
  432. The drive letters used by the JAM for the logical drives are determined by
  433. DOS.  When DOS initializes JAM.SYS during the processing of CONFIG.SYS, it
  434. informs the JAM of the next available drive letter. JAM.SYS reports to DOS
  435. the number of drives it controls. DOS then knows what drive letter to
  436. assign to the next block device driver it processes. You can change the
  437. drive letters used by the JAM by installing JSWAP utility (see also section
  438. 4.8 in the JAM User's Guide) or (if you have other block device drivers
  439. in your CONFIG.SYS file) by moving JAM.SYS around in the CONFIG.SYS file.
  440. The JAM displays the drive letters it uses on the screen every time the
  441. computer is powered up.
  442.  
  443. Some networks assign their drives to drive letters in a non-standard way.
  444. If there is a conflict between a drive letter used by the JAM and one used
  445. by a network drive, one drive or the other will be unavailable.  The only
  446. solution in the present time (other than that mentioned above) is to
  447. reconfigure the network drive to use a letter that doesn't conflict with
  448. the JAM.  No data will be lost on the logical drive even if it is
  449. temporarily unavailable due to a lettering conflict.
  450.  
  451.  
  452. 5.6. INTERLNK & INTERSVR programs
  453. ---------------------------------
  454.  
  455. The INTERLNK & INTERSVR programs, introduced with MS-DOS 6, are
  456. supposed to provide a mechanism of sharing resources of two computers
  457. linked with a null-modem. The INTERLNK driver should be installed
  458. on a local (master) machine, while INTERSVR must work on the remote
  459. (slave) computer. During installation INTERLNK asks INTERSVR about
  460. existing devices on a remote computer and makes copies of their
  461. device drivers on the local system. Later, when you try to access a
  462. remote drive, you send request to its local driver, that is controlled
  463. by INTERLNK. Then INTERLNK will transfer that request to the INTERSVR
  464. on the remote machine, and INTERSVR will call the actual device driver
  465. to perform the request.
  466.  
  467. We have descrived that mechanism, to show that INTERLNK & INTERSVR
  468. programs do not form a network file system themselves, and as the
  469. result they can work ONLY WITH STANDARD DOS DEVICE DRIVERS.
  470.  
  471. Thus, if you instruct INTERLNK to redirect a JAM drive on a remove
  472. machine, INTERLNK will reproduce on a local machine only JAM's device
  473. driver, while all the functions that JAM supports on the DOS interface
  474. level will not be handled on a local machine. For example, you would
  475. see unrealistic amount of free space on a remote JAM drive, the other
  476. JAM utilities will not recognize that drive as a JAM one, etc.
  477. Moreover, if that drive is mounted with enabled [DirectWrite]
  478. protection, JAM driver will block all write requests from the INTERSVR,
  479. so that you will not be able to write files on remote JAM drives.
  480.  
  481. Nevertheless, there is an alternative way of using JAM with INTERLNK.
  482. You should install a JAM device driver on a local machine (before or
  483. after INTERLNK). Then, when INTERLNK will redirect all the standard
  484. drives from a remote machine, you should run JMOUNT to mount a remote
  485. JAM file on a local JAM drive.
  486.  
  487.  Note: being run from a local machine, JMOUNT may not be able to
  488.        determine the type of a remote host drive, and whether the JAM
  489.        file is already mounted. So, make sure that your JAM file is
  490.        not located on a compressed drive (D*Space, Stacker, etc.),
  491.        and is unmounted.
  492.  
  493. Working in this mode, you can get all the benifits of data compression
  494. in distributed system: a) INTERLNK will transfer only COMPRESSED DATA,
  495. that JAM driver reads from or writes to the remote file, b) built-in
  496. JAM device driver cache systems will represent a LOCAL cache for
  497. UNCOMPRESSED remote data, c) using an external disk cache utility, you
  498. will be able to add an additional LOCAL cache for COMRESSED remote
  499. data, and so on.
  500.  
  501.  
  502. 5.7. Disk repairing/defragmentation utilities
  503. ---------------------------------------------
  504.  
  505. We DO NOT recommend you to run standard disk defragmentation utilities
  506. like Norton Utilities' SPEEDISK (MS-DOS/PC-DOS 6+ DEFRAG), Central
  507. Point Software's COMPRESS, Gazelle Systems' OPTune and alike on the
  508. JAM drives.
  509.  
  510. The JAM has a JCHKDSK disk-repairing utility and JMAX optimizer that are
  511. specifically designed for the JAM compressed data. Commercial defragmenters
  512. will NOT produce a well organized compressed disk, and in some cases
  513. actually DAMAGE the compressed data.
  514.  
  515. There is nothing wrong however, with running your commercial defragmenter
  516. (and/or disk check/repair utility) over a disk that is not controlled by
  517. the JAM.SYS.
  518.  
  519. Moreover, it is HIGHLY RECOMMENDED to run the standard defragmenter on
  520. your hard disk drive before you create a new or extend an existing JAM
  521. file.
  522.  
  523. If you have not any of the commercial programs above, or you find that
  524. your defragmenter works too slow, we could suggest you to try a
  525. shareware Disk OrGanizer by G. Allen Morris:
  526.      ftp: oak.oakland.edu:/SimTel/msdos/diskutils/dog316.zip.
  527.  
  528.  
  529. 5.8. UnErase/UnDelete utilities
  530. -------------------------------
  531.  
  532. The JAM package enables you to use utility programs (e.g. MS-DOS's
  533. (Central Point Software's) Undelete, Norton Utilities' Quick-Unerase,
  534. etc.) to perform UnDelete operations on erased files residing on JAM
  535. drives.
  536.  
  537. Almost all UnDelete programs use low-level disk access methods, so that
  538. you will need to enable DirectWrite mode for the JAM drive before run
  539. such program on it. This technique is described in section 3.6
  540. "UnDelete operation support" in the JAM User's Guide.
  541.  
  542. However, there are several UnDelete utilities (like XTreeGold's "Oops"
  543. command) which use another approach to recover deleted files. Instead
  544. of direct modification of FAT and directory, they create file with the
  545. same name, using DOS's create function, then change current position in
  546. it (lseek) on the length of deleted file, and finally, fix the file
  547. size by writing zero bytes, and closing it.
  548.  
  549. In several cases this method creates files with wrong information,
  550. however it is much easier, and uses only DOS functions (so that it
  551. may be possible to recover files on networked, and any other
  552. devices with compatible file system).
  553.  
  554. Unfortunately, this method works correctly on JAM drives, only if you
  555. are using the Full Undelete compatible mode (see note "JAM Allocation
  556. Strategies" at section 4.3 in the JAM User's Guide).
  557.  
  558. In standard mode, JAM driver clears deleted clusters when request on
  559. FAT modification is given by a standard DOS function. As the result,
  560. undeleted files (as well as any other files which you create without
  561. writting actual data in it) will contain zeros.
  562.  
  563.  
  564. 5.9. Disk Cache utilities
  565. -------------------------
  566.  
  567. The JAM is fully compatible with almost all standard disk cache utilities
  568. (including HyperDisk, Super PC-Kwik (or its OEM: PC-Cache and Qualitas
  569. Qcache), COMBI-Disk, etc.) which use INT 13h interface only.
  570.  
  571. Some modern disk caches (like SMARTdrive 4.0+, NCACHE2, NWCACHE, etc.)
  572. intercept (and/or reorganize) requests to all (existing at the moment
  573. of the cache initialization) DOS block device drivers, including the
  574. JAM ones. This means, that the data on the JAM drives would be cached
  575. TWICE:
  576.  
  577.   1. When DOS reads Original Data from/ writes to a JAM drive,
  578.  
  579.   2. When JAM driver reads Compressed Data from/ writes to a
  580.      Host drive for the JAM Archive,
  581.  
  582. and as the result, you would waste memory to keep two copies of the
  583. same data (in compresses and uncompressed form). Moreover, most
  584. probably, your cache program will not be able to handle embedded
  585. requests, and will hang your system (we have investigated this with
  586. SMARTdrive, and several other disk caches).
  587.  
  588. To prevent this effect JAM checks pointers on device drivers in DOS DPB
  589. (Disk Parameter Block) structures, and when JAM driver receives a test
  590. request sent via another block device, it detaches that intermediate
  591. driver:
  592.                              ,--------------------.
  593.     DOS      ,------------.  |                    |  - restored pointer
  594.    --------->| DPB (D:)   |  |  UNCOMPRESSED DATA |    to the JAM driver
  595.     REQUEST  |============|  |    ,------------.  |
  596.              | ......     |  |    | Disk cache |  |
  597.              | Dev.header ---/ -->| drive 2    |  |   ,-----------.
  598.              | ......     |   1st |============|  |   | JAM       |
  599.              `------------'  cache| Cacheable --- \-->| device    |
  600.                              level| drive hdr2 |      | driver    |
  601.              ,------------.       `------------'      |===========|
  602.              | DPB (C:)   |<--------------------------- Host drive|
  603.              |============|      COMPRESSED DATA      | DPB       |
  604.              | ......     |       ,------------.      `-----------'
  605.              | Dev.header ------->| Disk cache |
  606.              | ......     |   2nd | drive 1    |      ,-----------.
  607.              `------------'  cache|============|      | Host disk |
  608.                              level| Cacheable ------->| driver    |
  609.                                   | drive hdr2 |      |           |
  610.                                   `------------'      `-----------'
  611.  
  612. Thus, whenever you would run such a disk-cache utility, JAM will detach
  613. all extra cache drives, and your cache utility will work correctly.
  614.  
  615. Nevertheless, if it is possible to install your disk cache from the
  616. CONFIG.SYS file, you should load it BEFORE JAM.SYS driver. Doing so you
  617. would reduce the size of your cache in memory and will not produce any
  618. phantom cache drives.
  619.  
  620.  
  621. 5.10. Data encryption software
  622. -------------------------------
  623.  
  624. There are three main kinds of security programs:
  625.  
  626.   * First (like DR/Novell-DOS LOGIN and PASSWORD commands, MITAC's Advanced
  627.     Disk Manager, passwords in FastBack, etc.) offer "password protection
  628.     security" which don't perform any encryption, but simply do a password
  629.     check to allow access to the data.
  630.  
  631.     There is no any restriction on using such programs with the JAM.
  632.     You should only keep in mind, that if your JAM archive file is located
  633.     on a password-protected drive/or directory, you should make this place
  634.     accessible when JMOUNT will work.
  635.  
  636.   * Second (like Unix's Crypt, Norton Utilities' Diskreet, Central Point
  637.     Software's PC-SECURE, encryption features of Arc, Arj, Lotus 123, Lotus
  638.     Symphony, Microsoft Excel, Microsoft Mail, Microsoft Word, Paradox,
  639.     Pkzip, etc.) can encrypt individual files, so that you (or someone
  640.     else) cannot view their original contents.
  641.  
  642.     Such encrypted files (in most cases) are not compressible and will be
  643.     stored in uncompressed form, even if you store such files on a JAM
  644.     compressed drive.
  645.  
  646.     You might want to store incompressible files on an uncompressed
  647.     drive rather than on a JAM drive. Doing so can sometimes improve
  648.     your system's speed.
  649.  
  650.   * Third (like Peter Gutmann's SFS) will create a secure disk (encrypted
  651.     diskette or whole hard disk partition), which cannot be accessed except
  652.     with a password.
  653.  
  654.     JAM is fully compatible with such programs. Moreover using the JAM over
  655.     SFS-encrypted disk you can improve security and speed up the disk
  656.     access. To mount a JAM archive located on an encrypted SFS drive you
  657.     should load SYS.SYS driver and activate the secure drive before
  658.     running JMOUNT.COM program.
  659.  
  660. 5.11 Windows 3.xx
  661. ------------------
  662.  
  663. The JAM 1.25 is fully compatible with Windows 3.0, Windows 3.1, and
  664. Windows for Workgroups 3.11. Some detailed information about hints in
  665. using it with the JAM drives is given below.
  666.  
  667.   1. If you are installing Microsoft Windows 3.1 onto a JAM drive, we
  668.      suggest you take the following course of action while in the Windows
  669.      3.1 Setup program;
  670.  
  671.      a. When given the option of which installation mode to use,
  672.         select the:
  673.  
  674.         "Custom Setup" option versus the "Express Setup" option.
  675.  
  676.      b. When you are prompted for the path to Windows install, use a
  677.         fully qualified path such as; "C:\WINDOWS" or "C:\WIN31".
  678.  
  679.   2. If you use Microsoft Windows 3.x on your PC, and want to move it
  680.      on the JAM drive, you should use the JSWAP utility to swap the
  681.      JAM drive letter with that on which Windows is currently located.
  682.  
  683.   3. If you cannot start JMW, make sure you have installed JMW.PIF into your
  684.      \WINDOWS directory (and possibly edited it with PIF Editor to
  685.      reflect your JAM path settings).
  686.  
  687.   4. If JMW complains about CTL3DV2.DLL not properly installed, make
  688.      sure that file is copied to your \WINDOWS\SYSTEM directory.
  689.  
  690.  
  691. 5.11. Executable file compressors
  692. ----------------------------------
  693.  
  694. If you use programs which compress executable files (like PKLITE, LZEXE,
  695. DIET, etc.), do not use them over JAM utilities which can be loaded
  696. as device drivers. These include JCREATE, JMOUNT and JSWAP programs.
  697. If you do compress them and then attempt to load them from CONFIG.SYS,
  698. your system will most probably hang.
  699.  
  700.  
  701. 6. Possible problems
  702. =====================
  703.  
  704. Note: This section is intended as an aid to JAM users.
  705. It covers some of common situations with JAM which are often
  706. experienced by our users and contains 'recipes' how to resolve them.
  707.  
  708. This section is not to be meant as a constitution to the JAM
  709. documentation; please refer to it for full description of the JAM
  710. functionality. Note also the Frequently Asked Questions list.
  711.  
  712.  
  713. 6.1. JMOUNT displays the message "JAM file is too fragmented"
  714. --------------------------------------------------------------
  715.  
  716. The JAM is able to handle Archive Files which consist of up to 16 separate
  717. contiguous areas (fragments) upon the Host Drive. A file that resides in
  718. many such separate areas is said to be Fragmented. Large Archive Files
  719. might to be too fragmented for the JAM to handle, and therefore require
  720. special treatment.
  721.  
  722. Run a disk defragmentation utility (e.g. Gazelle Systems' OPTune, Norton
  723. Utilities' SPEEDISK (MS-DOS 6.0+ DEFRAG), Central Point Software's
  724. COMPRESS, and alike) on your Host Drive, and then rerun JMOUNT.
  725.  
  726. NOTE: Such utilities usually do not work with DOS files that have the
  727. "Hidden" attribute. Therefore, you must first remove the "Hidden" attribute
  728. from the JAM files. You should then use the utility program to reorganize
  729. the Host Drive, and once again assign the "Hidden" attribute to the JAM
  730. files. Having done so, IMMEDIATELY REBOOT the computer system.
  731.  
  732. 6.2. Some of your programs tell that JAM drive is write-protected
  733. ------------------------------------------------------------------
  734.  
  735. You may receive such message under one of the following circumstances:
  736.  
  737.   1. There is an error in JAM drive data structure, and JAM.SYS has
  738.      switched drive in read-only mode (to minimize the data corruption).
  739.  
  740.      Run JCHKDSK /T on your JAM drive. If JCHKDSK will find any error,
  741.      follow the steps described in Section 4.5 and Appendix B. of the
  742.      JAM User's Guide.
  743.  
  744.   2. You use some incompatible Device driver or TSR program, which is
  745.      loaded over the JAM.SYS driver and call it directly (i.e. bypassing
  746.      DOS kernel). For instance, we have detected such situation with:
  747.  
  748.        a) Stacker and others disk-compressors, which compressed volume
  749.           files were located on a JAM drive;
  750.  
  751.        b) the "Dir", and several other computer viruses.
  752.  
  753.      Try to disable each of your TSR program and device drivers (except
  754.      the JAM one), and investigate this problem again. If doing so, you
  755.      will find a program which conflicts with the JAM driver, try (if it
  756.      is possible) to load it before the JAM.SYS device driver in your
  757.      CONFIG.SYS file.
  758.  
  759.   3. Your program uses direct disk access.
  760.  
  761.      Some low-level disk utilities (e.g. Norton Utilities' DiskEdit,
  762.      DiskTools, UnErase, SpeeDisk, Directory Sort, etc.), use direct 
  763.      disk access (DOS interrupt 26h, direct requests to device driver, 
  764.      etc.) to perform non-standard activities like file UnDelete 
  765.      operations, reorganization files on disk, and so on.
  766.  
  767.      To enable direct write operations on the JAM drive, you should use
  768.      JMOUNT utility. For more information about JMOUNT utility and the JAM
  769.      [DirectWrite] mode read Section 4.5 of the JAM User's Guide.
  770.  
  771. 6.3. You find that your JAM drive is mounted as a read-only disk.
  772. ------------------------------------------------------------------
  773.  
  774. A serious error in the JAM archive file structure was detected. To minimize
  775. the data loss, the following steps should be taken:
  776.  
  777.   1. Run JCHKDSK /T on the JAM drive.
  778.  
  779.   2. Analyze the list of errors produced by JCHKDSK.
  780.      a) Select all clusters which cannot be expanded.
  781.      b) Select files which have these non-expandable clusters.
  782.      c) Copy these files on any other drive, by DOS COPY command
  783.         On all messages like:
  784.          'Unable to read data from drive x: (Abort,Ignore,Fail)?'
  785.          answer 'I'- ignore.
  786.  
  787.   3. Run JCHKDSK /T /F again. On all messages like:
  788.      'Cluster #yyyyy (file 'xxxxxxxxxx') cannot be expanded, Clear it [Y/N]?
  789.       answer 'Y' - clear.
  790.  
  791.   4. Run JMOUNT /U /W  to switch the drive in read-write mode.
  792.  
  793.   5. Replace all files which you have corrected by their copies.
  794.  
  795. 6.4. You cannot copy files onto JAM drive when it is not full.
  796. ---------------------------------------------------------------
  797.  
  798. You may receive such situation when physical free space of your JAM
  799. drive is too fragmented.  Since JAM always allocates continuous chunks
  800. of disk for compressed clusters, it may not write some files into JAM
  801. drive with sufficient (but too fragmented) physical space free.
  802. Solution: run JMAX on your JAM drive (JMAX /m0 would suffice to only
  803. unfragment free space).  It may be worth running JCHKDSK before just to
  804. ensure that there is no other problems with your JAM drive.  Please
  805. refer to JAM.DOC for details on using JMAX (section 4.6).
  806.  
  807.  
  808. 7. Addendum to the JAM User's Guide
  809. ====================================
  810.  
  811. This section provides some important information which is not included in
  812. the JAM User's Guide.
  813.  
  814. 7.1. The JCHAIN utility
  815. ------------------------
  816.  
  817. Transfers the control (when CONFIG.SYS is executing) to another
  818. configuration file.
  819.  
  820. Syntax
  821.  
  822.     DEVICE=[d2:][\][path2\]
  823.         JCHAIN.SYS [? ["message_string"]] [d:][\][path\]filename [/Q]
  824.  
  825. Parameters
  826.  
  827. ? ["message_string"]
  828.     Prompts you about whether or not you want to transfer control to
  829.     a different configuration file. To specify the text for the prompt
  830.     you should include a message string after ?, enclosed by double
  831.     quotation marks.
  832.  
  833. [d:][\][path\]
  834.     Full or relative path of the configuration file. This is optional
  835.     part of the name of the configuration file. If you omit it, JCHAIN
  836.     uses current DOS drive/directory to find specified filename.
  837.  
  838. filename
  839.     Specifies the name of the configuration file to transfer control to.
  840.  
  841. [d2:][\][path2\]
  842.     Specifies the location of the JCHAIN.SYS file.
  843.  
  844. Switches
  845.  
  846. /Q
  847.     Quiet mode (does not display copyright information).
  848.  
  849. Notes
  850.  
  851. JCHAIN automatically verifies that specified configuration file exists.
  852. If it does exist, the current configuration file is closed and the
  853. operating system begins executing the statements in new file. If it
  854. does not exist, processing returns to the original configuration file.
  855.  
  856. Note: If you use the JCHAIN utility to transfer control to a
  857.     configuration file on another drive, JCHAIN sets the current DOS
  858.     drive to the last one. This means that if you won't specify the
  859.     full path in all DEVICE and INSTALL statements in secondary
  860.     configuration file, DOS will try to find programs to execute on
  861.     the drive containing this file.
  862.  
  863. The main purpose of the JCHAIN utility in JAM package is to allow
  864. you load the JAM device driver, JMOUNT and JSWAP utilities from a
  865. separate file before or after executing of all the program in the
  866. standard CONFIG.SYS file.
  867.  
  868. Thus, to compress a bootable hard disk partition (say drive C:) you may
  869. leave on it only system files: IO.SYS (or IBMBIO.COM) + MSDOS.SYS (or
  870. IBMDOS.COM), JAM utilities (JAM, JMOUNT, JSWAP, and JCHAIN), put the
  871. other files into a JAM file (say, C:\SYSTEM.JAM), and create a new file
  872. CONFIG.SYS, consisting of the following statements:
  873.  
  874.     DEVICE=C:\JAM.SYS
  875.     DEVICE=C:\JMOUNT.COM C:\SYSTEM.JAM
  876.     DEVICE=C:\JSWAP.COM C: D:
  877.     DEVICE=D:\JCHAIN.SYS C:\CONFIG.SYS
  878.  
  879. During the system start-up the JAM driver will be installed first (say
  880. as drive D:), then the JAM archive with user's files fill be mounted on
  881. that drive, drives C: and D: will be swapped, and finally, JCHAIN will
  882. transfer control to original configuration file. As a result, user's
  883. system will be loaded from JAM compressed disk in a completely
  884. transparent manner.
  885.  
  886. JCHAIN is also useful when you are using a system with read-only or ROM
  887. disks; JCHAIN allows you to change the configuration specified in the
  888. ROM-based copy of CONFIG.SYS.
  889.  
  890. Using the JCHAIN's "?" command you can also group together similar
  891. CONFIG.SYS commands into additional CONFIG.SYS files and then execute
  892. them with a single conditional statement. The last feature represents
  893. a powerful method of organization of multiple configurations under
  894. MS/PC-DOS 3..5. It may also be used as an addition or alternative to
  895. the MS/PC-DOS 6's [menu] statements in CONFIG.SYS file.
  896.  
  897. Example
  898.  
  899. The following sequence of statements includes a command for JCHAIN
  900. utility to look for the CONFIG.SYS file on drive D: when the operating
  901. system reaches the DEVICE=C:\JAM\JCHAIN.SYS ... line during execution.
  902. If a CONFIG.SYS file exists on drive D:, that file will be executed
  903. rather than the one containing the statement for JCHAIN utility. If
  904. CONFIG.SYS does not exist on drive D:, the original CONFIG.SYS
  905. continues to execute.
  906.  
  907.     DOS=HIGH
  908.     COUNTRY=44,,C:\DOS\COUNTRY.SYS
  909.     DEVICE=C:\JAM\JCHAIN.SYS D:\CONFIG.SYS
  910.  
  911.  
  912. 7.2. The JPROTECT utility
  913. --------------------------
  914.  
  915. The detailed documentation on JPROTECT utility is arranged now as a
  916. separate file JPROTECT.DOC.
  917.  
  918.  
  919. 8. Technical support
  920. =====================
  921.  
  922. We hope that your use of the JAM will be enjoyable and trouble-free.
  923. It is our intention to provide the best possible product and documentation.
  924. We understand that problems may arise, and in most cases you will be able
  925. to resolve any problems you may have by referring to the documentation.
  926. Answers to questions you might have will usually be found within pages of
  927. the JAM User's Guide.
  928.  
  929. If you find that you need technical support you can send your requests
  930. to:
  931.  
  932.     JAM Software
  933.     George A. Reznik              Internet: gar@UA.NET   (the best way)
  934.     Vasilkovskaya str.8, apt.139            gar@jam.kiev.ua
  935.     252040 Kiev, UKRAINE
  936.  
  937.     Voice:  +7(044) 266-6547      Monday through Friday,
  938.                                   6 pm to 10pm Kiev Time (+7 hours GMT)
  939.     FAX:    +7(044) 266-4091      Monday through Friday,
  940.                                   9 am to 5 pm Kiev Time (+7 hours GMT)
  941.     BBS:    +7(044) 266-6547      without weekends
  942.                                   11pm to 7 am Kiev Time (+7 hours GMT).
  943.  
  944. We will be happy to help you with problems and answer your questions.
  945. We would also like to hear any suggestions you have for how the JAM
  946. can be improved.
  947.  
  948.  
  949.